home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds / rpccmd.man < prev    next >
Encoding:
Text File  |  1992-07-10  |  3.8 KB  |  95 lines
  1. ' $Header: /sprite/src/cmds/rpccmd/RCS/rpccmd.man,v 1.8 92/07/10 14:59:54 kupfer Exp $ SPRITE (Berkeley)
  2. .so \*(]ltmac.sprite
  3. .HS RPCCMD cmds
  4. .BS
  5. .SH NAME
  6. rpccmd \- Control the RPC system
  7. .SH SYNOPSIS
  8. \fBrpccmd\fR  [\fIoptions\fR]
  9. .SH OPTIONS
  10. .IP "\fB\-on\fR" 14
  11. Turn on the server half of the RPC system.
  12. .IP "\fB\-off\fR"
  13. Turn off the server half of the RPC system.
  14. .IP "\fB\-ping \fIhost\fR"
  15. Do an RPC test against the specified host.
  16. .IP "\fB\-b \fIsize\fR"
  17. The amount of data to send in each RPC test.
  18. .IP "\fB\-t \fR[\fB0|1\fR]"
  19. Set the value of the rpc_Tracing variable.  RPC tracing facilitates
  20. debugging, but adds overhead to each RPC. 
  21. .IP "\fB\-D \fR[\fB0|1\fR]"
  22. Set the value of the rpc_Debug variable.  A non-zero value causes
  23. each RPC to be logged to \fR/dev/syslog\fR.  This really slows things down!
  24. .IP "\fB\-T \fR[\fB0|1\fR]"
  25. Set the value of the rpc_NoTimeouts variable.  A non-zero value
  26. makes all RPCs try forever.  This is dangerous because a server call-back
  27. to a dead client will hang the server.
  28. .IP "\fB\-C \fR[\fB0|1\fR]"
  29. Turn off/on timings of RPC on the client side.  Use 
  30. .B rpcstat
  31. to dump out the histograms of times that are taken by the kernel.
  32. .IP "\fB\-S \fR[\fB0|1\fR]"
  33. Turn off/on timing of the RPC service times as measured by the server.
  34. .IP "\fB\-Creset\fR"
  35. Reset the client-side timing histograms.
  36. .IP "\fB\-Sreset\fR"
  37. Reset the server-side timing histograms.
  38. .IP "\fB\-maxServers \fInumber\fR"
  39. Set the maximum number of allowed rpc server processes.
  40. .IP "\fB\-numServers \fInumber\fR"
  41. Create more rpc servers until this number exists.
  42. .IP "\fB\-negAcksOn\fR"
  43. Allow the machine to generate negative acknowledgements.
  44. .IP "\fB\-negAcksOff\fR"
  45. Prevent the machine from generating negative acknowledgements.
  46. .IP "\fB\-channelNegAcksOn\fR"
  47. Turn on the client policy of ramping down the number of channels it uses
  48. with a server that has returned a negative acknowledgement recently.
  49. .IP "\fB\-channelNegAcksOff\fR"
  50. Turn off the client policy of ramping down the number of channels it uses
  51. with a server that has returned a negative acknowledgement recently.
  52. Use back-off instead.
  53. .IP "\fB\-numPings\fR"
  54. Number of pings to send to the specified host (defaults to 100).
  55. .IP "\fB\-sanity \fR[\fB0|1\fR]"
  56. Turn off/on sanity checking of RPC packets.  The types of sanity checks done
  57. are intended for debugging
  58. purposes and probably shouldn't be used during normal operation.
  59. .BE
  60. .SH INTRODUCTION
  61. .PP
  62. This command is used to set various control parameters of the RPC system.
  63. The most important is the \fB\-on\fR option, which is used during the boot
  64. sequence to enable RPC service after local initialization (i.e. disk checks)
  65. is done.  The \fB\-ping\fR option is used to ping another sprite host.  This
  66. is useful to find out if the host is up, and the make sure that the
  67. host knows you are alive.  This does an RPC_SEND, and the amount of
  68. data sent can be specified with the \fB\-b\fR option.
  69. .PP
  70. Each of the \fB\-t\fR, \fB\-D\fR, \fB\-T\fR, \fB\-C\fR, and \fB\-S\fR
  71. options set the value
  72. of a kernel variable.  \fB\-t\fR is used to turn on or off the trace of the last
  73. 100 RPC packets.  \fB\-D\fR is used to turn on or off debugging print statements.
  74. \fB\-T\fR is used to turn on or off "no timeout mode".  This mode is useful
  75. when debugging a client and you don't want the server to timeout
  76. and think the client has crashed.  It is dangerous, however, because
  77. if the server ever makes a call-back to a truely dead client it
  78. will hang until the no timeout mode is turned off.  
  79. .PP
  80. The \fB\-C\fR and \fB\-S\fR
  81. options turn on or off timings of individual RPCs.  \fB\-C\fR controls timing
  82. on the client side, and \fB\-S\fR controls timing on the server side.
  83. The timings are
  84. kept in histogram form.  Use the 
  85. .B \-Creset
  86. and
  87. .B \-Sreset
  88. options to zero out the histograms.  Use 
  89. .B rpcstat 
  90. to display them.  
  91. .SH "SEE ALSO"
  92. rpcstat
  93. .SH KEYWORDS
  94. rpc, trace, debug
  95.